Read(Byte[],Int32,Int32) Method

Reads data into the application provided buffer and advances the current position of the stream.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
Public Overrides NotOverridable Function Read( _
   ByVal buffer() As Byte, _
   ByVal offset As Integer, _
   ByVal count As Integer _
) As Integer

'Usage
 
Dim instance As TdStream
Dim buffer() As Byte
Dim offset As Integer
Dim count As Integer
Dim value As Integer
 
value = instance.Read(buffer, offset, count)

public override int Read( 
   byte[] buffer,
   int offset,
   int count
)

public:
int Read( 
   array<byte>^ buffer,
   int offset,
   int count
) override

Parameters

buffer: Specifies a Byte array to read data into.
offset: Specifies the location within the buffer to read data into.
count: Specifies the number of bytes to read into the buffer

Return Value

Returns the number of bytes read from the Advanced SQL Engine and written into the . The number will be equal or less than .

Exceptions

Exception	Description
System.ArgumentNullException	buffer is null.
System.ArgumentOutOfRangeException	count or offset is negative or the sum of offset and count is larger than the buffer length.
System.InvalidOperationException	The TdConnection is closed.
System.ObjectDisposedException	The `TdStream` is closed / dispose.
TdException	The SQL Engine returned an error, or the .NET Data Provider for Teradata detected an error.

Remarks

The .NET Data Provider for Teradata reads the LOB from Teradata and transfers it to the application provided buffer.

Requirements

Product	Versions	Platforms
.NET	6, 7	Windows, Linux, MacOS
.NET Framework	4.6.2, 4.7, 4.7.1, 4.7.2, 4.8	Windows
.NET Standard	2.0	Windows, Linux, MacOS

Reference

TdStream Class
TdStream Members